Inside Macintosh: QuickDraw GX Objects /

Chapter 6 - Transform Objects / Transform Objects Reference

Functions / Transforming Shapes by Modifying Transform Mappings

GXMoveTransformTo

You can use the GXMoveTransformTo function to alter the mapping property of a transform object so that it moves its associated shape to a specified position.

void GXMoveTransformTo(gxTransform target, Fixed x, Fixed y);

target

A reference to the transform object whose mapping property you want to alter.

x

The horizontal coordinate of the desired position.

y

The vertical coordinate of the desired position.

DESCRIPTION

The GXMoveTransformTo function calculates a new mapping matrix for the transform object referenced by the target parameter. When applied to a shape, the new mapping matrix performs the same mapping transformations on the shape as the original matrix, except that the new matrix moves the shape to the position specified by the x and y parameters.

The horizontal and vertical coordinates are specified in geometry space. However, the position they specify relates only to the translation values in the mapping itself; the values in a shape's geometry are added to these values to determine the shape's final position in local space.

ERRORS, WARNINGS, AND NOTICES

Errors
out_of_memory
transform_is_nil
Warnings
move_transform_out_of_range
Notices (debugging version)
mapping_unaffected

SEE ALSO

For an example of the use of this function, see page 6-24.

For information about mapping matrices in general, see the mathematics chapter of Inside Macintosh: QuickDraw GX Environment and Utilities.

To move a shape to a specified position by altering its geometry, use the GXMoveShapeTo function, described on page 6-67.